home *** CD-ROM | disk | FTP | other *** search
/ CU Amiga Super CD-ROM 15 / CU Amiga Magazine's Super CD-ROM 15 (1997)(EMAP Images)(GB)[!][issue 1997-10].iso / CUCD / Graphics / Ghostscript / source / zfile.c < prev    next >
C/C++ Source or Header  |  1997-04-19  |  26KB  |  883 lines
  1. /* Copyright (C) 1989, 1995, 1996, 1997 Aladdin Enterprises.  All rights reserved.
  2.   
  3.   This file is part of Aladdin Ghostscript.
  4.   
  5.   Aladdin Ghostscript is distributed with NO WARRANTY OF ANY KIND.  No author
  6.   or distributor accepts any responsibility for the consequences of using it,
  7.   or for whether it serves any particular purpose or works at all, unless he
  8.   or she says so in writing.  Refer to the Aladdin Ghostscript Free Public
  9.   License (the "License") for full details.
  10.   
  11.   Every copy of Aladdin Ghostscript must include a copy of the License,
  12.   normally in a plain ASCII text file named PUBLIC.  The License grants you
  13.   the right to copy, modify and redistribute Aladdin Ghostscript, but only
  14.   under certain conditions described in the License.  Among other things, the
  15.   License requires that the copyright notice and this notice be preserved on
  16.   all copies.
  17. */
  18.  
  19. /* zfile.c */
  20. /* Non-I/O file operators */
  21. #include "memory_.h"
  22. #include "string_.h"
  23. #include "ghost.h"
  24. #include "gp.h"
  25. #include "gsstruct.h"            /* for registering root */
  26. #include "errors.h"
  27. #include "oper.h"
  28. #include "estack.h"            /* for filenameforall, .execfile */
  29. #include "ialloc.h"
  30. #include "ilevel.h"            /* %names only work in Level 2 */
  31. #include "interp.h"            /* gs_errorinfo_put_string prototype */
  32. #include "isave.h"            /* for restore */
  33. #include "iutil.h"
  34. #include "stream.h"
  35. #include "strimpl.h"
  36. #include "sfilter.h"
  37. #include "gxiodev.h"            /* must come after stream.h */
  38.                     /* and before files.h */
  39. #include "files.h"            /* ditto */
  40. #include "fname.h"            /* ditto */
  41. #include "main.h"            /* for gs_lib_paths */
  42. #include "store.h"
  43.  
  44. /* Import the file_open routine for %os%, which is the default. */
  45. extern iodev_proc_open_file(iodev_os_open_file);
  46.  
  47. /* Forward references: file opening. */
  48. int file_open(P6(const byte *, uint, const char *, uint, ref *, stream **));
  49.  
  50. /* Forward references: other. */
  51. private int execfile_finish(P1(os_ptr));
  52. private int execfile_cleanup(P1(os_ptr));
  53. private stream_proc_report_error(filter_report_error);
  54.  
  55. /*
  56.  * Since there can be many file objects referring to the same file/stream,
  57.  * we can't simply free a stream when we close it.  On the other hand,
  58.  * we don't want freed streams to clutter up memory needlessly.
  59.  * Our solution is to retain the freed streams, and reuse them.
  60.  * To prevent an old file object from being able to access a reused stream,
  61.  * we keep a serial number in each stream, and check it against a serial
  62.  * number stored in the file object (as the "size"); when we close a file,
  63.  * we increment its serial number.  If the serial number ever overflows,
  64.  * we leave it at zero, and do not reuse the stream.
  65.  * (This will never happen.)
  66.  *
  67.  * Storage management for this scheme is a little tricky.
  68.  * We maintain an invariant that says that a stream opened at a given
  69.  * save level always uses a stream structure allocated at that level.
  70.  * By doing this, we don't need to keep track separately of streams open
  71.  * at a level vs. streams allocated at a level.  To make this interact
  72.  * properly with save and restore, we maintain a list of all streams
  73.  * currently allocated, both open and closed.  The save_count member
  74.  * of a stream indicates the number of unmatched saves at which
  75.  * the given stream was the head of the list.  Thus the streams
  76.  * allocated at the current level are precisely those from the head of the
  77.  * list up to and not including the first stream with non-zero save_count.
  78.  *
  79.  * We want to close streams freed by restore and by garbage collection.
  80.  * We use the finalization procedure for this.  For restore, we don't
  81.  * have to do anything special to make this happen; we only need to ensure
  82.  * that we remove from the list of allocated streams any streams being freed,
  83.  * as just described.  For garbage collection, we do something more drastic:
  84.  * we simply clear the list of known streams (at all save levels).
  85.  * Any streams open at the time of garbage collection will no longer
  86.  * participate in the list of known streams, but this does no harm;
  87.  * it simply means that they won't get reused, and can only be reclaimed
  88.  * by a future garbage collection or restore.
  89.  */
  90. private stream *file_list;
  91. private gs_gc_root_t file_list_root;
  92.  
  93. /* 
  94.  * Define the default stream buffer sizes.  For file streams,
  95.  * this is arbitrary, since the C library or operating system
  96.  * does its own buffering in addition.
  97.  * However, the buffer size for eexec decoding is NOT arbitrary:
  98.  * it must be at most 512.
  99.  */
  100. #define default_buffer_size 512
  101. const uint file_default_buffer_size = default_buffer_size;
  102.  
  103. /* An invalid file object */
  104. stream *invalid_file_entry;        /* exported for zfileio.c */
  105. private gs_gc_root_t invalid_file_root;
  106.  
  107. /* Initialize the file table */
  108. private void
  109. zfile_init(void)
  110. {
  111.     /* Create and initialize an invalid (closed) stream. */
  112.     /* Initialize the stream for the sake of the GC, */
  113.     /* and so it can act as an empty input stream. */
  114.  
  115.     stream *s = s_alloc(imemory_system, "zfile_init");
  116.     sread_string(s, NULL, 0);
  117.     s->next = s->prev = 0;
  118.     s->save_count = 0;
  119.     s_init_no_id(s);
  120.     invalid_file_entry = s;
  121.     gs_register_struct_root(imemory, &invalid_file_root,
  122.                 (void **)&invalid_file_entry,
  123.                 "invalid_file_entry");
  124.  
  125.     /* Initialize the bookkeeping list. */
  126.     
  127.     file_list = 0;
  128.     gs_register_struct_root(imemory, &file_list_root,
  129.                 (void **)&file_list, "file_list");
  130. }
  131.  
  132. /* Make an invalid file object. */
  133. void
  134. make_invalid_file(ref *fp)
  135. {    make_file(fp, avm_system, ~0, invalid_file_entry);
  136. }
  137.  
  138. /* <name_string> <access_string> file <file> */
  139. int
  140. zfile(register os_ptr op)
  141. {    char file_access[3];
  142.     parsed_file_name pname;
  143.     const byte *astr;
  144.     int code;
  145.     stream *s;
  146.     check_read_type(*op, t_string);
  147.     astr = op->value.const_bytes;
  148.     switch ( r_size(op) )
  149.        {
  150.     case 2:
  151.         if ( astr[1] != '+' )
  152.             return_error(e_invalidfileaccess);
  153.         file_access[1] = '+';
  154.         file_access[2] = 0;
  155.         break;
  156.     case 1:
  157.         file_access[1] = 0;
  158.         break;
  159.     default:
  160.         return_error(e_invalidfileaccess);
  161.        }
  162.     switch ( astr[0] )
  163.        {
  164.     case 'r': case 'w': case 'a':
  165.         break;
  166.     default:
  167.         return_error(e_invalidfileaccess);
  168.        }
  169.     file_access[0] = astr[0];
  170.     code = parse_file_name(op - 1, &pname);
  171.     if ( code < 0 )
  172.         return code;
  173.     if ( pname.iodev == NULL )
  174.         pname.iodev = iodev_default;
  175.     if ( pname.fname == NULL )        /* just a device */
  176.         code = (*pname.iodev->procs.open_device)(pname.iodev,
  177.                     file_access, &s, imemory);
  178.     else                    /* file */
  179.     {    iodev_proc_open_file((*open_file)) =
  180.             pname.iodev->procs.open_file;
  181.         if ( open_file == 0 )
  182.             open_file = iodev_os_open_file;
  183.         code = (*open_file)(pname.iodev, pname.fname, pname.len,
  184.                     file_access, &s, imemory);
  185.     }
  186.     if ( code < 0 )
  187.         return code;
  188.     make_stream_file(op - 1, s, file_access);
  189.     pop(1);
  190.     return code;
  191. }
  192.  
  193. /* ------ Level 2 extensions ------ */
  194.  
  195. /* <string> deletefile - */
  196. private int
  197. zdeletefile(register os_ptr op)
  198. {    parsed_file_name pname;
  199.     int code = parse_real_file_name(op, &pname, "deletefile");
  200.     if ( code < 0 )
  201.         return code;
  202.     code = (*pname.iodev->procs.delete_file)(pname.iodev, pname.fname);
  203.     free_file_name(&pname, "deletefile");
  204.     if ( code < 0 )
  205.         return code;
  206.     pop(1);
  207.     return 0;
  208. }
  209.  
  210. /* <template> <proc> <scratch> filenameforall - */
  211. /****** NOT CONVERTED FOR IODEVICES YET ******/
  212. private int file_continue(P1(os_ptr));
  213. private int file_cleanup(P1(os_ptr));
  214. private int
  215. zfilenameforall(register os_ptr op)
  216. {    file_enum *pfen;
  217.     int code;
  218.     check_write_type(*op, t_string);
  219.     check_proc(op[-1]);
  220.     check_read_type(op[-2], t_string);
  221.     /* Push a mark, the pattern, the scratch string, the enumerator, */
  222.     /* and the procedure, and invoke the continuation. */
  223.     check_estack(7);
  224.     pfen = gp_enumerate_files_init((char *)op[-2].value.bytes, r_size(op - 2), imemory);
  225.     if ( pfen == 0 )
  226.       return_error(e_VMerror);
  227.     push_mark_estack(es_for, file_cleanup);
  228.     *++esp = op[-2];
  229.     *++esp = *op;
  230.     ++esp;
  231.     make_istruct(esp, 0, pfen);
  232.     *++esp = op[-1];
  233.     pop(3);  op -= 3;
  234.     code = file_continue(op);
  235.     return (code == o_pop_estack ? o_push_estack : code);
  236. }
  237. /* Continuation operator for enumerating files */
  238. private int
  239. file_continue(register os_ptr op)
  240. {    es_ptr pscratch = esp - 2;
  241.     file_enum *pfen = r_ptr(esp - 1, file_enum);
  242.     uint len = r_size(pscratch);
  243.     uint code =
  244.       gp_enumerate_files_next(pfen, (char *)pscratch->value.bytes, len);
  245.     if ( code == ~(uint)0 )        /* all done */
  246.        {    esp -= 4;        /* pop proc, pfen, scratch, mark */
  247.         return o_pop_estack;
  248.        }
  249.     else if ( code > len )        /* overran string */
  250.         return_error(e_rangecheck);
  251.     else
  252.        {    push(1);
  253.         ref_assign(op, pscratch);
  254.         r_set_size(op, code);
  255.         push_op_estack(file_continue);    /* come again */
  256.         *++esp = pscratch[2];    /* proc */
  257.         return o_push_estack;
  258.        }
  259. }
  260. /* Cleanup procedure for enumerating files */
  261. private int
  262. file_cleanup(os_ptr op)
  263. {    gp_enumerate_files_close(r_ptr(esp + 4, file_enum));
  264.     return 0;
  265. }
  266.  
  267. /* <string1> <string2> renamefile - */
  268. private int
  269. zrenamefile(register os_ptr op)
  270. {    parsed_file_name pname1, pname2;
  271.     int code = parse_real_file_name(op - 1, &pname1, "renamefile(from)");
  272.     if ( code < 0 )
  273.         return code;
  274.     pname2.fname = 0;
  275.     code = parse_real_file_name(op, &pname2, "renamefile(to)");
  276.     if ( code < 0 || pname1.iodev != pname2.iodev ||
  277.          (code = (*pname1.iodev->procs.rename_file)(pname1.iodev,
  278.                      pname1.fname, pname2.fname)) < 0
  279.        )
  280.     {    if ( code >= 0 )
  281.             code = gs_note_error(e_invalidfileaccess);
  282.     }
  283.     free_file_name(&pname2, "renamefile(to)");
  284.     free_file_name(&pname1, "renamefile(from)");
  285.     if ( code < 0 )
  286.         return code;
  287.     pop(2);
  288.     return 0;
  289. }    
  290.  
  291. /* <file> status <open_bool> */
  292. /* <string> status <pages> <bytes> <ref_time> <creation_time> true */
  293. /* <string> status false */
  294. private int
  295. zstatus(register os_ptr op)
  296. {    switch ( r_type(op) )
  297.     {
  298.     case t_file:
  299.       {    stream *s;
  300.         make_bool(op, (file_is_valid(s, op) ? 1 : 0));
  301.       }    return 0;
  302.     case t_string:
  303.     {    parsed_file_name pname;
  304.         struct stat fstat;
  305.         int code = parse_file_name(op, &pname);
  306.         if ( code < 0 )
  307.             return code;
  308.         code = terminate_file_name(&pname, "status");
  309.         if ( code < 0 )
  310.             return code;
  311.         code = (*pname.iodev->procs.file_status)(pname.iodev,
  312.                 pname.fname, &fstat);
  313.         switch ( code )
  314.         {
  315.         case 0:
  316.             push(4);
  317.             make_int(op - 4, stat_blocks(&fstat));
  318.             make_int(op - 3, fstat.st_size);
  319.             make_int(op - 2, fstat.st_mtime);
  320.             make_int(op - 1, fstat.st_ctime);
  321.             make_bool(op, 1);
  322.             break;
  323.         case e_undefinedfilename:
  324.             make_bool(op, 0);
  325.             code = 0;
  326.         }
  327.         free_file_name(&pname, "status");
  328.         return code;
  329.     }
  330.     default:
  331.         return_op_typecheck(op);
  332.     }
  333. }
  334.  
  335. /* ------ Non-standard extensions ------ */
  336.  
  337. /* <executable_file> .execfile - */
  338. private int
  339. zexecfile(register os_ptr op)
  340. {    check_type_access(*op, t_file, a_executable | a_read | a_execute);
  341.     check_estack(4);    /* cleanup, file, finish, file */
  342.     push_mark_estack(es_other, execfile_cleanup);
  343.     *++esp = *op;
  344.     push_op_estack(execfile_finish);
  345.     return zexec(op);
  346. }
  347. /* Finish normally. */
  348. private int
  349. execfile_finish(os_ptr op)
  350. {    check_ostack(1);
  351.     esp -= 2;
  352.     execfile_cleanup(op);
  353.     return o_pop_estack;
  354. }
  355. /* Clean up by closing the file. */
  356. private int
  357. execfile_cleanup(os_ptr op)
  358. {    check_ostack(1);
  359.     *++osp = esp[2];
  360.     return zclosefile(osp);
  361. }
  362.  
  363. /* <dir> <name> .filenamedirseparator <string> */
  364. int
  365. zfilenamedirseparator(os_ptr op)
  366. {    const char *sepr;
  367.  
  368.     check_read_type(*op, t_string);
  369.     check_read_type(op[-1], t_string);
  370.     sepr =
  371.       gp_file_name_concat_string((const char *)op[-1].value.const_bytes,
  372.                      r_size(op - 1),
  373.                      (const char *)op->value.const_bytes,
  374.                      r_size(op));
  375.     make_const_string(op - 1, avm_foreign | a_readonly,
  376.               strlen(sepr), (const byte *)sepr);
  377.     pop(1);
  378.     return 0;
  379. }
  380.  
  381. /* - .filenamelistseparator <string> */
  382. int
  383. zfilenamelistseparator(os_ptr op)
  384. {    push(1);
  385.     make_const_string(op, avm_foreign | a_readonly, 1,
  386.               (const byte *)&gp_file_name_list_separator);
  387.     return 0;
  388. }
  389.  
  390. /* <name> .filenamesplit <dir> <base> <extension> */
  391. int
  392. zfilenamesplit(os_ptr op)
  393. {    check_read_type(*op, t_string);
  394.     /****** NOT IMPLEMENTED YET ******/
  395.     return_error(e_undefined);
  396. }
  397.  
  398. /* <string> findlibfile <found_string> <file> true */
  399. /* <string> findlibfile <string> false */
  400. int
  401. zfindlibfile(register os_ptr op)
  402. {    int code;
  403. #define maxclen 200
  404.     byte cname[maxclen];
  405.     uint clen;
  406.     parsed_file_name pname;
  407.     stream *s;
  408.     check_ostack(2);
  409.     code = parse_file_name(op, &pname);
  410.     if ( code < 0 )
  411.         return code;
  412.     if ( pname.iodev == NULL )
  413.         pname.iodev = iodev_default;
  414.     if ( pname.iodev != iodev_default )
  415.     {    /* Non-OS devices don't have search paths (yet). */
  416.         code =
  417.           (pname.fname == NULL ?
  418.            (*pname.iodev->procs.open_device)(pname.iodev, "r",
  419.                              &s, imemory) :
  420.            (*pname.iodev->procs.open_file)(pname.iodev,
  421.                            pname.fname, pname.len, "r",
  422.                            &s, imemory));
  423.         if ( code < 0 )
  424.         {    push(1);
  425.             make_false(op);
  426.             return 0;
  427.         }
  428.         make_stream_file(op + 1, s, "r");
  429.     }
  430.     else
  431.     {    byte *cstr;
  432.         code = lib_file_open(pname.fname, pname.len, cname, maxclen,
  433.                      &clen, op + 1);
  434.         if ( code == e_VMerror )
  435.           return code;
  436.         if ( code < 0 )
  437.         {    push(1);
  438.             make_false(op);
  439.             return 0;
  440.         }
  441.         cstr = ialloc_string(clen, "findlibfile");
  442.         if ( cstr == 0 )
  443.             return_error(e_VMerror);
  444.         memcpy(cstr, cname, clen);
  445.         make_string(op, a_all | icurrent_space, clen, cstr);
  446.     }
  447.     push(2);
  448.     make_true(op);
  449.     return 0;
  450. }
  451.  
  452. /* ------ Initialization procedure ------ */
  453.  
  454. BEGIN_OP_DEFS(zfile_op_defs) {
  455.     {"1deletefile", zdeletefile},
  456.     {"1.execfile", zexecfile},
  457.     {"2file", zfile},
  458.     {"3filenameforall", zfilenameforall},
  459.     {"2.filenamedirseparator", zfilenamedirseparator},
  460.     {"0.filenamelistseparator", zfilenamelistseparator},
  461.     {"1.filenamesplit", zfilenamesplit},
  462.     {"1findlibfile", zfindlibfile},
  463.     {"2renamefile", zrenamefile},
  464.     {"1status", zstatus},
  465.         /* Internal operators */
  466.     {"0%file_continue", file_continue},
  467.     {"0%execfile_finish", execfile_finish},
  468. END_OP_DEFS(zfile_init) }
  469.  
  470. /* ------ Stream opening ------ */
  471.  
  472. /* Make a t_file reference to a stream. */
  473. void
  474. make_stream_file(ref *pfile, stream *s, const char *access)
  475. {    uint attrs =
  476.         (access[1] == '+' ? a_write + a_read + a_execute : 0) |
  477.         imemory_space((gs_ref_memory_t *)s->memory);
  478.     if ( access[0] == 'r' )
  479.     {    make_file(pfile, attrs | (a_read | a_execute), s->read_id, s);
  480.         s->write_id = 0;
  481.     }
  482.     else
  483.     {    make_file(pfile, attrs | a_write, s->write_id, s);
  484.         s->read_id = 0;
  485.     }
  486. }
  487.  
  488. /* Open an OS-level file (like fopen), using the search paths if necessary. */
  489. /* Note that it does not automatically look in the current */
  490. /* directory first (or at all): this is like Unix, and unlike MS-DOS. */
  491. private int
  492. lib_file_fopen(gx_io_device *iodev, const char *bname,
  493.   const char *ignore_access, FILE **pfile, char *rfname, uint rnamelen)
  494. {    char fmode[3];            /* r, [b], null */
  495.     int len = strlen(bname);
  496.     const gs_file_path *pfpath = &gs_lib_path;
  497.     uint pi;
  498.  
  499.     strcpy(fmode, "r");
  500.     strcat(fmode, gp_fmode_binary_suffix);
  501.     if ( gp_file_name_is_absolute(bname, len) )
  502.       return (*iodev->procs.fopen)(iodev, bname, fmode, pfile,
  503.                        rfname, rnamelen);
  504.     /* Go through the list of search paths */
  505.     for ( pi = 0; pi < r_size(&pfpath->list); ++pi )
  506.        {    const ref *prdir = pfpath->list.value.refs + pi;
  507.         const char *pstr = (const char *)prdir->value.const_bytes;
  508.         uint plen = r_size(prdir);
  509.         const char *cstr =
  510.           gp_file_name_concat_string(pstr, plen, bname, len);
  511.         int up, i;
  512.         int code;
  513.  
  514.         /* Concatenate the prefix, combiner, and file name. */
  515.         /* Do this carefully in case rfname is the same */
  516.         /* as fname.  (We don't worry about the case */
  517.         /* where rfname only overlaps fname.) */
  518.         up = plen + strlen(cstr);
  519.         if ( up + len + 1 > rnamelen )
  520.           return_error(e_limitcheck);
  521.         for ( i = len + 1; --i >= 0; )
  522.           rfname[i + up] = bname[i];
  523.         memcpy(rfname, pstr, plen);
  524.         memcpy(rfname + plen, cstr, strlen(cstr));
  525.         code = (*iodev->procs.fopen)(iodev, rfname, fmode,
  526.                          pfile, rfname, rnamelen);
  527.         if ( code >= 0 )
  528.           return code;
  529.         /* strcpy isn't guaranteed to work for overlapping */
  530.         /* source and destination, so: */
  531.         if ( rfname == bname )
  532.           for ( i = 0; (rfname[i] = rfname[i + up]) != 0; i++ )
  533.             ;
  534.        }
  535.     return_error(e_undefinedfilename);
  536. }
  537. /* The startup code calls this to open @-files. */
  538. FILE *
  539. lib_fopen(const char *bname)
  540. {    FILE *file = NULL;
  541.     /* We need a buffer to hold the expanded file name. */
  542. #define max_filename 129
  543.     char buffer[max_filename];
  544.     int code = lib_file_fopen(iodev_default, bname, "r", &file, 
  545.                   buffer, max_filename);
  546. #undef max_filename
  547.     return (code < 0 ? NULL : file);
  548. }
  549.  
  550. /* Open a file stream on an OS file and create a file object, */
  551. /* using the search paths. */
  552. /* The startup code calls this to open the initialization file gs_init.ps. */
  553. int
  554. lib_file_open(const char *fname, uint len, byte *cname, uint max_clen,
  555.   uint *pclen, ref *pfile)
  556. {    stream *s;
  557.     int code = file_open_stream(fname, len, "r",
  558.                     default_buffer_size, &s, lib_file_fopen);
  559.     char *bname;
  560.     uint blen;
  561.  
  562.     if ( code < 0 )
  563.       return code;
  564.     /* Get the name from the stream buffer. */
  565.     bname = (char *)s->cbuf;
  566.     blen = strlen(bname);
  567.     if ( blen > max_clen )
  568.     {    sclose(s);
  569.         return_error(e_limitcheck);
  570.     }
  571.     memcpy(cname, bname, blen);
  572.     *pclen = blen;
  573.     make_stream_file(pfile, s, "r");
  574.     return 0;
  575. }
  576.  
  577. /* Open a file stream that reads a string. */
  578. /* (This is currently used only by the ccinit feature.) */
  579. /* The string must be allocated in non-garbage-collectable (foreign) space. */
  580. int
  581. file_read_string(const byte *str, uint len, ref *pfile)
  582. {    stream *s = file_alloc_stream(imemory, "file_read_string");
  583.     int space;
  584.  
  585.     if ( s == 0 )
  586.       return_error(e_VMerror);
  587.     space = icurrent_space;
  588.     sread_string(s, str, len);
  589.     s->foreign = 1;
  590.     s->write_id = 0;
  591.     make_file(pfile, a_readonly | space, s->read_id, s);
  592.     s->save_close = s->procs.close;
  593.     s->procs.close = file_close_disable;
  594.     return 0;
  595. }
  596.  
  597. /* Open a file stream, optionally on an OS file. */
  598. /* Return 0 if successful, error code if not. */
  599. /* On a successful return, the C file name is in the stream buffer. */
  600. /* If fname==0, set up the file entry, stream, and buffer, */
  601. /* but don't open an OS file or initialize the stream. */
  602. int
  603. file_open_stream(const char *fname, uint len, const char *file_access,
  604.   uint buffer_size, stream **ps, iodev_proc_fopen_t fopen_proc)
  605. {    byte *buffer;
  606.     register stream *s;
  607.     if ( buffer_size == 0 )
  608.       buffer_size = default_buffer_size;
  609.     if ( len >= buffer_size )
  610.       return_error(e_limitcheck);    /* we copy the file name into the buffer */
  611.     /* Allocate the stream first, since it persists */
  612.     /* even after the file has been closed. */
  613.       s = file_alloc_stream(imemory, "file_open_stream");
  614.     if ( s == 0 )
  615.         return_error(e_VMerror);
  616.     /* Allocate the buffer. */
  617.     buffer = ialloc_bytes(buffer_size, "file_open(buffer)");
  618.     if ( buffer == 0 )
  619.         return_error(e_VMerror);
  620.     if ( fname != 0 )
  621.        {    /* Copy the name (so we can terminate it with a zero byte.) */
  622.         char *file_name = (char *)buffer;
  623.         char fmode[4];        /* r/w/a, [+], [b], null */
  624.         FILE *file;
  625.         int code;
  626.         memcpy(file_name, fname, len);
  627.         file_name[len] = 0;        /* terminate string */
  628.         /* Open the file, always in binary mode. */
  629.         strcpy(fmode, file_access);
  630.         strcat(fmode, gp_fmode_binary_suffix);
  631.         /****** iodev_default IS QUESTIONABLE ******/
  632.         code = (*fopen_proc)(iodev_default, file_name, fmode, &file,
  633.                      (char *)buffer, buffer_size);
  634.         if (code < 0 )
  635.         {    ifree_object(buffer, "file_open(buffer)");
  636.             return code;
  637.         }
  638.         /* Set up the stream. */
  639.         switch ( fmode[0] )
  640.         {
  641.         case 'a':
  642.             sappend_file(s, file, buffer, buffer_size);
  643.             break;
  644.         case 'r':
  645.             sread_file(s, file, buffer, buffer_size);
  646.             break;
  647.         case 'w':
  648.             swrite_file(s, file, buffer, buffer_size);
  649.         }
  650.         if ( fmode[1] == '+' )
  651.           s->file_modes |= s_mode_read | s_mode_write;
  652.         s->save_close = s->procs.close;
  653.         s->procs.close = file_close_file;
  654.        }
  655.     else                /* save the buffer and size */
  656.        {    s->cbuf = buffer;
  657.         s->bsize = s->cbsize = buffer_size;
  658.        }
  659.     *ps = s;
  660.     return 0;
  661. }
  662.  
  663. /* Open a file stream for a filter. */
  664. int
  665. filter_open(const char *file_access, uint buffer_size, ref *pfile,
  666.   const stream_procs _ds *procs, const stream_template *template,
  667.   const stream_state *st)
  668. {    stream *s;
  669.     uint ssize = gs_struct_type_size(template->stype);
  670.     stream_state *sst = 0;
  671.     int code;
  672.  
  673.     if ( template->stype != &st_stream_state )
  674.     {    sst = s_alloc_state(imemory, template->stype,
  675.                     "filter_open(stream_state)");
  676.         if ( sst == 0 )
  677.           return_error(e_VMerror);
  678.     }
  679.     code = file_open_stream((char *)0, 0, file_access,
  680.                 buffer_size, &s, (iodev_proc_fopen_t)0);
  681.     if ( code < 0 )
  682.     {    ifree_object(sst, "filter_open(stream_state)");
  683.         return code;
  684.     }
  685.     s_std_init(s, s->cbuf, s->bsize, procs,
  686.            (*file_access == 'r' ? s_mode_read : s_mode_write));
  687.     s->procs.process = template->process;
  688.     s->save_close = s->procs.close;
  689.     s->procs.close = file_close_file;
  690.     if ( sst == 0 )
  691.     {    /* This stream doesn't have any state of its own. */
  692.         /* Hack: use the stream itself as the state. */
  693.         sst = (stream_state *)s;
  694.     }
  695.     else if ( st != 0 )    /* might not have client parameters */
  696.       memcpy(sst, st, ssize);
  697.     s->state = sst;
  698.     sst->template = template;
  699.     sst->memory = imemory;
  700.     sst->report_error = filter_report_error;
  701.     if ( template->init != 0 )
  702.     {    code = (*template->init)(sst);
  703.         if ( code < 0 )
  704.         {    ifree_object(sst, "filter_open(stream_state)");
  705.             ifree_object(s->cbuf, "filter_open(buffer)");
  706.             return code;
  707.         }
  708.     }
  709.     make_stream_file(pfile, s, file_access);
  710.     return 0;
  711. }
  712.  
  713. /* Report an error by storing it in $error.errorinfo. */
  714. private int
  715. filter_report_error(stream_state *st, const char *str)
  716. {    if_debug1('s', "[s]stream error: %s\n", str);
  717.     return gs_errorinfo_put_string(str);
  718. }
  719.  
  720. /* Allocate and return a file stream. */
  721. /* Return 0 if the allocation failed. */
  722. /* The stream is initialized to an invalid state, so the caller need not */
  723. /* worry about cleaning up if a later step in opening the stream fails. */
  724. stream *
  725. file_alloc_stream(gs_memory_t *mem, client_name_t cname)
  726. {    stream *s;
  727.     /* Look first for a free stream allocated at this level. */
  728.     s = file_list;
  729.     while ( s != 0 && s->save_count == 0 )
  730.     {    if ( !s_is_valid(s) && s->read_id != 0 /* i.e. !overflowed */
  731.              && s->memory == mem
  732.            )
  733.         {    s->is_temp = 0;        /* not a temp stream */
  734.             return s;
  735.         }
  736.         s = s->next;
  737.     }
  738.     s = s_alloc(mem, cname);
  739.     if ( s == 0 )
  740.       return 0;
  741.     s_init_ids(s);
  742.     s->is_temp = 0;            /* not a temp stream */
  743.     /* Disable the stream now (in case we can't open the file, */
  744.     /* or a filter init procedure fails) so that `restore' won't */
  745.     /* crash when it tries to close open files. */
  746.     s_disable(s);
  747.     /* Add s to the list of files. */
  748.     if ( file_list != 0 )
  749.       file_list->prev = s;
  750.     s->next = file_list;
  751.     s->prev = 0;
  752.     s->save_count = 0;
  753.     file_list = s;
  754.     return s;
  755. }
  756.  
  757. /* ------ Stream closing ------ */
  758.  
  759. /* Finish closing a file stream.  This used to check whether it was */
  760. /* currentfile, but we don't have to do this any longer. */
  761. /* This replaces the close procedure for the std* streams, */
  762. /* which cannot actually be closed. */
  763. /* This is exported for ziodev.c. */
  764. int
  765. file_close_finish(stream *s)
  766. {    return 0;
  767. }
  768.  
  769. /* Close a file stream, but don't deallocate the buffer. */
  770. /* This replaces the close procedure for %lineedit and %statementedit. */
  771. /* (This is WRONG: these streams should allocate a new buffer each time */
  772. /* they are opened, but that would overstress the allocator right now.) */
  773. /* This is exported for ziodev.c. */
  774. /* This also replaces the close procedure for the string-reading */
  775. /* stream created for gs_run_string. */
  776. int
  777. file_close_disable(stream *s)
  778. {    int code = (*s->save_close)(s);
  779.     if ( code )
  780.       return code;
  781.     /* Increment the IDs to prevent further access. */
  782.     s->read_id = s->write_id = (s->read_id | s->write_id) + 1;
  783.     return file_close_finish(s);
  784. }
  785.  
  786. /* Close a file stream.  This replaces the close procedure in the stream */
  787. /* for normal (OS) files and for filters. */
  788. int
  789. file_close_file(stream *s)
  790. {    stream *stemp = s->strm;
  791.     gs_memory_t *mem;
  792.     int code = file_close_disable(s);
  793.     if ( code )
  794.       return code;
  795.     /*
  796.      * Check for temporary streams created for filters.
  797.      * There may be more than one in the case of a procedure-based filter,
  798.      * or if we created an intermediate stream to ensure
  799.      * a large enough buffer.  Note that these streams may have been
  800.      * allocated by file_alloc_stream, so we mustn't free them.
  801.      */
  802.     while ( stemp != 0 && stemp->is_temp != 0 )
  803.     {    stream *snext = stemp->strm;
  804.         mem = stemp->memory;
  805.         if ( stemp->is_temp > 1 )
  806.          gs_free_object(mem, stemp->cbuf,
  807.                 "file_close(temp stream buffer)");
  808.         s_disable(stemp);
  809.         stemp = snext;
  810.     }
  811.     mem = s->memory;
  812.     gs_free_object(mem, s->cbuf, "file_close(buffer)");
  813.     return 0;
  814. }
  815.  
  816. /* Close a file object. */
  817. /* This is exported only for gsmain.c. */
  818. int
  819. file_close(ref *pfile)
  820. {    stream *s;
  821.     if ( file_is_valid(s, pfile) )    /* closing a closed file is a no-op */
  822.       {    if ( sclose(s) )
  823.           return_error(e_ioerror);
  824.       }
  825.     return 0;
  826. }
  827.  
  828. /* ------ Memory management ------ */
  829.  
  830. /* Mark the current file list at a save. */
  831. void
  832. file_save(void)
  833. {    if_debug1('u', "[u]file_save 0x%lx\n",
  834.           (ulong)file_list);
  835.     if ( file_list != 0 )
  836.       file_list->save_count++;
  837. }
  838.  
  839. /* Update the file list before a restore. */
  840. void
  841. file_restore(const alloc_save_t *save, const gs_memory_t *mem)
  842. {    stream *prev = 0;
  843.     stream *s;
  844.     stream **ps;
  845.     /* We must be careful to unlink only those streams which */
  846.     /* were allocated in the VM space being restored. */
  847.     for ( ps = &file_list; (s = *ps) != 0 && s->save_count == 0; )
  848.       if ( s->memory == mem )
  849.         { if ( (*ps = s->next) != 0 )
  850.         (*ps)->prev = prev;
  851.         }
  852.       else
  853.         prev = s, ps = &s->next;
  854.     if ( s != 0 )            /* i.e., s->save_count != 0 */
  855.       s->save_count--;
  856.     if_debug2('u', "[u]file_restore 0x%lx for 0x%lx\n",
  857.           (ulong)file_list, (ulong)save);
  858. }
  859.  
  860. /* Note that a save has been forgotten. */
  861. void
  862. file_forget_save(const alloc_save_t *save)
  863. {    stream *s;
  864.     for ( s = file_list; s != 0 && s->save_count == 0; )
  865.       s = s->next;
  866.     if ( s != 0 )
  867.       s->save_count--;
  868.     if_debug2('u', "[u]file_forget_save 0x%lx for 0x%lx\n",
  869.           (ulong)file_list, (ulong)save);
  870. }
  871.  
  872. /* Clear the file list for a GC. */
  873. void
  874. file_gc_prepare(void)
  875. {    /* We have to unlink every stream from its neighbors, */
  876.     /* so that referenced streams don't keep all streams around. */
  877.     while ( file_list != 0 )
  878.       {    stream *s = file_list;
  879.         file_list = s->next;
  880.         s->prev = s->next = 0;
  881.       }
  882. }
  883.